Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Generating Pictures From Movies

GetTrackPict

The GetTrackPict function creates a QuickDraw picture from the specified track at the specified time. This function is similar to the GetMoviePict function (described on page 2-134), except that GetTrackPict uses only the specified track to create the picture.

pascal PicHandle GetTrackPict (Track theTrack, TimeValue time);

theTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

time

Specifies the track image for the picture. The time parameter contains the time from which the image is taken.

DESCRIPTION

The GetTrackPict function returns a handle to the picture. Your application must dispose of this picture handle by calling QuickDraw's KillPicture routine. If the function could not create the picture, the returned handle is set to nil.

SPECIAL CONSIDERATIONS

You can specify a disabled track. If the track contains compressed data, the picture created by this function may also contain compressed data that cannot be displayed without QuickTime.

ERROR CODES

invalidTrack	-2009	This track is corrupted or invalid
invalidTime	-2015	This time value is invalid

Image Compression Manager errors
Memory Manager errors